Readme for Linux LMS/BLX Library V1.10 — June 17, 2026

This version of the Vaunix Linux LMS/BLX library is based on libusb 1.0.
If your system does not have the developer version of libusb 1.0 installed, install it before building:

    sudo apt-get install libusb-1.0-0-dev

You can check for the location of the installed `libusb.h` file using:

    sudo updatedb && locate libusb.h

On some systems, you may need to explicitly add the path to `libusb.h` in the Makefile
(typically with `-I/usr/include/libusb-1.0`) if it's not already found by default.

To build the shared library, run:

    make

This will compile the source files in the `src/` directory and produce `liblmshid.so` in the current directory.

To clean up build artifacts, run:

    make clean

Note: the included .so file was built using Ubuntu 20.04 LTS. 
While it may work on compatible Linux systems, users of other distributions, versions, 
or architectures may need to rebuild the library for their specific environment.

For most systems, copy the liblmshid.so file to /user/lib where it can be accessed by programs as needed at run time.

If you are creating a c or c++ based application, the lmsdrvr.h file contains prototypes for the functions in the library, lmsusb.h
has the library's internal definitions and some generally useful symbol definitions.

An example of how to use the LMS support library from Python is included. The LMS support library is designed so that it can be easily
accessed using the Python c_types extension. The example is a simple command line utility that shows how to load, initialize, and use
the LMS support library.
